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1.0  Overview
=============

This IBMWIFI2.EXE package provides you with IBM's most current support for 
the IBM International High Rate Wireless LAN PC Card on the OS/2 Operating 
System.

1.1  The IBMWIFI2.EXE file that you received contains the following files 
in a self-extracting compressed format.

  IBMWIFI2.NIF
  IBMWIFI2.OS2
  IBMWIFI2.MSG
  IBMWIFI2.DDP
  WIFISTAT.EXE
  WIFIICON.CMD

2.0  Installation Instructions
===========================================================

2.1  Using IBMWIFI2.EXE

To use the IBM International High Rate Wireless LAN PC Card Drivers for OS/2,
you must expand the IBMWIFI2.EXE file into its component files by

(a.) copy IBMWIFI2.EXE to a temporary directory, e.g. c:\temp
(b.) run IBMWIFI2.EXE to unpack the installation files

Please make sure that you delete all other files from this directory. It is 
recommended not to mix other installation files into this temporary directory.

2.2  Installation using the DDINSTALL utility

This package contains a DDP file for installation with the DDINSTALL utility. 
It copies the driver files into the \IBMCOM and \IBMCOM\MACS subdirectories. 
Run DDINSTALL from an OS/2 command prompt or click on the "Device Driver 
Installation" icon in the "System Setup" folder and follow the instructions.

(a.) Select the correct path to the temporary directory from section 2.1.
(b.) Select "IBM High Rate Wireless LAN PC Card-128 NDIS driver, V.1.0" from 
the list, and press "OK".
(c.) Start MPTS and create a network adapter choosing "IBM High Rate Wireless 
LAN PC Card-128" from the adapter list. It is required to specify a network 
name and security options, see section 4.0 for additional information.

2.3. Installation of the Wifi Signal Strength monitor utility

(a.) The files WIFISTAT.EXE and WIFIICON.CMD are copied into \IBMCOM during 
step 2.2.
(b.) To create a desktop icon, simply run WIFIICON.CMD.


3.0  Requirements
=================

3.1  Hardware

High Rate Wireless LAN PC Card drivers are designed to work on IBM ThinkPad 
Models supported by OS/2.

     Tests are performed for following devices:

     o  ThinkPad 760, 760XD, 770, 770X
     o  ThinkPad 600E, 600X
     o  ThinkPad T20, T21, T23

3.2  Software

The High Rate Wireless LAN PC Card drivers require PCMCIA 2.0 (or higher) 
support and a working Socket Service driver. The drivers are NDIS 2.01 
compatible.

4.0  Configuration parameters
=============================

4.1  Network parameters

Network Name (SSID)

With "Network Name (SSID)" you specify the network name of your wireless 
network. The network name can be up to 32 characters long. If the WLAN 
adapter should accept any network available, then specify "ANY" as Network 
Name (SSID).

Support Peer to Peer connections

Set this parameter to "YES" if you want to support a network without base 
stations. If the WLAN Adapter does not find an existing network, it will 
create one with Network Name (SSID) as network name.

4.2 Power Management parameters

Power Management

There are several power management modes for this adapter. It depends on 
the access point if power management can be used. The optimal setting is 
"EPS" which is supported by most new access points. To disable power 
management, set it to "DISABLED".

Possible settings are:

DISABLED	Power Management is disabled.
ENABLED		Power Management is enabled, however, this is not the 
		optimal setting.
NO_RX_MCAST	Power Management is enabled, and Multicast Packets will not 
		be received if they are the only reason to wake up the card.
QUEUE_MCAST 	Power Management is enabled, and Multicast Packets are queued 
		for transmission until the card is awake. NO_RX_MCAST is also 
		active.
EPS		Enhanced Power Management is enabled. This seems to be the 
		optimal setting.
EPS_NO_RX_MCAST	Enhanced Power Management is enabled, and Multicast Packets 
		will not be received if they are the only reason to wake up 
		the card.
EPS_QUEUE_MCAST	Enhanced Power Management is enabled, and Multicast Packets 
		are queued for transmission until the card is awake. 
		EPS_NO_RX_MCAST	is also active.

4.3 Encryption

The driver supports WEP 40 Bit and 128 Bit encryption. The keys must be 
specified in the PROTOCOL.INI file.

Use Encryption

Set this parameter to "YES" to use encryption. The keys specified in KEY_1 to 
KEY_4 will be used. The keys can be either 40 or 128 Bit in length, both 
lengths can be mixed.

TX_KEY Number

Specifies which key will be used for the encryption of transmitted packets.

KEY_1..KEY_4

These parameters specify the keys for the encryption algorithm. At least one 
key must be specified. Note that it is necessary to have the same key number 
for a specific key on all network stations. The keys can be specified as 
ASCII strings or as HEX strings with a preceding "0x" before the string.

4.4 Resource allocation

For PCMCIA cards it should not be necessary to offer the possibility to 
explicitly configure interrupts. That defeats PCMCIA. Nonetheless, to give 
the user the ability to administer resources, parameters are implemented. 
The parameters can be specified in the PROTOCOL.INI file or in the MPTS 
program.

IO_BASE

Specify an I/O address, which should be used for this adapter. The adapter 
needs a contiguous space of 64 (0x40) I/O addresses. If you specify IO_BASE, 
you also need to specify an IRQ number, unless you use the polling option.

IRQ

Specify an IRQ, which should be used for the adapter. The adapter requires 
an exclusive IRQ line.

USE_POLLING

With this parameter you can use polling instead of interrupts. It is intended 
for misbehaving PCMCIA sockets, which prevent a working IRQ for the adapter. 
It is required to have TIMER0.SYS installed to use this option (OS/2 Warp 4.0 
or higher has TIMER0.SYS installed by default).

5.0 WifiStat wireless network monitor utility
============================================

This utility displays following information about wireless LAN connection:
	o Wireless network adapter status
	o Network name 
	o Wireless signal strength and network connection speed

5.1 Enabling and disabling wireless connection

For enabling the wireless LAN connection do a right-click on WifiState 
application window and select "Radio On" (the default selection)from
pop-up menu. For disabling the wireless LAN connection do a right-click
on WifiState application window and select "Radio Off" from pop-up menu.

5.2 Displaying and hiding the network station name

For displaying the wireless LAN station name do a right-click on WifiState 
application window and select "Show SSID" (the default selection) from pop-up
menu. For hiding the wireless LAN station name do a right-click on WifiState 
application window and select "Hide SSID" from pop-up menu.

5.3 Wireless LAN profiles

This feature allows to define up to 4 different Wireless network profiles
for the adapter. Switching between these defined networks is possible 
without making changes in MPTS and rebooting the system. 

5.3.1 Adding / modifying profiles

Do a right-click on WifiState application widow and choose "Add/Edit Profile"
pop-up menu. In Profile selection window choose the desired profile radio button
and select "Profile settings". In settings window define all necessary settings
for desired Wireless network. 
In case of infrastructure wireless network (with base stations) information 
about Network Name and Encryption Key settings may be obtained from your 
network administrator. 
In case of a Peer-To-Peer (ADHOC) wireless network Network Name and Encryption 
Key settings must match those specified on peer system.

5.3.2 Changing Wireless Networks

In order to change the active Wireless network do a "right-click" on WifiState
application window and from "Select Profile" menu choose the desired Wireless
network profile.
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